Code chunks

Abkürzungen:

• Cmd/Strg+Alt+I: neuen Code-Chunk einfügen

• Cmd/Strg+Enter: eine einzelne Code-Zeile ausführen

• Cmd/Strg+Shift+Enter: ganzen Code-Chunk ausführen

• Code Chunks sollten relativ in sich geschlossen (self-contained) sein

  • und auf eine einzige Aufgabe fokussiert sein

Chunk labels

• wir können jedem Code-Chunk Spezifikationen geben, indem wir #| direkt unter ```{r}
  • #| label: simple-math wird den Chunk simple-math nennen

```{r}
#| label: simple-math

4 + 4
```

[1] 8

Vorteile der Verwendung von Chunk-Labels

1. Über das Dropdown-Menü im Skript-Editor können wir zu bestimmten Code Chunks navigieren
2. Grafiken (z. B. Plots), die von Chunks erzeugt werden, erhalten nützliche Namen, die das spätere Auffinden erleichtern (mehr dazu in Kürze)

Chunk-Chunks sollten…

• kurz und informativ sein
• keine Leerzeichen enthalten (- oder _ verwenden) einmalig im Dokument sein (nicht wiederholt)

Globale Optionen

• die eben erwähnten Chunk-Optionen können auch global für euer gesamtes Dokument gesetzt werden, indem ihr sie in eurer YAML unter excute: hinzufügen

title: "My report"
format:
  html:
    toc: true
execute:
  echo: false

• und dann können nachfolgende Code-Chunks die globale Einstellung von Fall zu Fall außer Kraft setzen

Tabellen

• wir können Tabellen so ausgeben, wie wir sie in der Konsole sehen
• wir können auch weitere Formatierungen mit der Funktion kable() aus dem Paket knitr hinzufügen

df_flights %>% 
  select(1:5) %>% 
  head()

# A tibble: 6 × 5
   year month   day dep_time sched_dep_time
  <dbl> <dbl> <dbl>    <dbl>          <dbl>
1  2013     1     1      517            515
2  2013     1     1      533            529
3  2013     1     1      542            540
4  2013     1     1      544            545
5  2013     1     1      554            600
6  2013     1     1      554            558

df_flights %>% 
  select(1:5) %>% 
  head() %>% 
  knitr::kable()

Tabellenbeschriftungen

• wir können der Tabelle auch eine Beschriftung hinzufügen, indem wir ein label:
  • und muss mit tbl- für Tabellen beginnen
• Wir können auch eine Tabellenbeschriftung hinzufügen (tbl-cap:), die über der Tabelle gedruckt wird, wenn wir das Dokument rendern hinzufügen

Spaltennamen

• Zum Schluss drucken wir noch bessere Spaltennamen

```{r}
#| output-location: column-fragment
#| label: tbl-flights2
#| tbl-cap: "A table made with `knitr`."
df_flights %>% 
  select(1:5) %>% 
  head() %>% 
  knitr::kable(
    col.names = c("Year", "Month", "Day", 
                  "Dep. Time", "Sched. Dep. Time")
  ) %>%
  kable_styling(font_size = 25) # from kableExtra
```

Figuren

Figurenbeschriftung

• Beschriftungen (labels) für Code Chunks, die eine Abbildung ausdrucken, müssen mit fig- beginnen
  • die Figur hat dann eine Nummer, wenn sie gedruckt wird

```{r}
#| label: fig-flights-dec120

fig_flights
```

Abbildung 3: ?(caption)

Abbildungsbeschriftung

• fig-cap: fügt eine Bildunterschrift ein, die im gerenderten Dokument erscheint
  • die Beschriftung immer mit Anführungszeichen umschließen! z.B., fig-cap: "..."

```{r}
#| label: fig-flights-dec120-2
#| fig-cap: "Departure delay by arrival delay for December 2013. Airline is indicated via point colour."

fig_flights
```

Abbildung 4: Departure delay by arrival delay for December 2013. Airline is indicated via point colour.

Größe der Figuren

• Eine große Herausforderung bei Grafiken in Quarto ist es, die Figuren in die richtige Größe und Form zu bringen
• Es gibt fünf Hauptoptionen, die hilfreich sein können:
  • fig-width: legt die Breite der Figur in Zoll fest (z.B. fig-width = 4)
  • fig-height: legt die Höhe der Figur in Zoll fest (z. B. fig-height = 4)
  • fig-asp: legt das Seitenverhältnis der Figur fest (wenn Sie nur Höhe oder Breite festlegen; z. B. fig-asp = 0,618)
  • out-width: legt die Breite der Figur in Prozent der Zeilenbreite fest (z. B. out-width = "70%")
  • out-height: setzt die Höhe der Figur in Prozent zur Zeilenbreite (z.B. out-height = "30%")
  • fig-align: centre zentriert die Abbildung auf der Ausgabeseite

Querverweise

• Wir können auch im Text auf Diagramme oder Tabellen verweisen, indem wir @ gefolgt vom label eingeben
  • z.B.: Dies ist ein Text, der @fig-flights-dec120 beschreibt.